package com.school.sports.config;

import io.swagger.v3.oas.models.Components;
import io.swagger.v3.oas.models.ExternalDocumentation;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import io.swagger.v3.oas.models.security.SecurityRequirement;
import io.swagger.v3.oas.models.security.SecurityScheme;
import io.swagger.v3.oas.models.servers.Server;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.Arrays;
import java.util.List;

/**
 * Swagger API文档配置类
 * 用于配置OpenAPI 3.0规范的API文档
 *
 * @author 开发团队
 * @since 2025-10-13
 */
@Configuration
public class SwaggerConfig {

    @Value("${server.port:8089}")
    private String serverPort;

    @Value("${server.servlet.context-path:/api}")
    private String contextPath;

    /**
     * 自定义OpenAPI配置
     * 配置API文档的基本信息、服务器信息、安全认证等
     */
    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                // API基本信息
                .info(new Info()
                        .title("校园运动会管理系统API")
                        .description("校园运动会管理系统后端接口文档，提供用户管理、运动会管理、报名管理、成绩管理等功能的API接口")
                        .version("1.0.0")
                        .contact(new Contact()
                                .name("开发团队")
                                .email("support@example.com")
                                .url("https://github.com/example/school-sports-management"))
                        .license(new License()
                                .name("MIT License")
                                .url("https://opensource.org/licenses/MIT")))

                // 服务器配置（兼容Java 8）
                .servers(Arrays.asList(
                        new Server()
                                .url("http://localhost:" + serverPort + contextPath)
                                .description("开发环境服务器"),
                        new Server()
                                .url("https://api.example.com" + contextPath)
                                .description("生产环境服务器")
                ))

                // 外部文档链接
                .externalDocs(new ExternalDocumentation()
                        .description("项目完整文档")
                        .url("https://docs.example.com"))

                // 全局安全认证配置
                .components(new Components()
                        .addSecuritySchemes("Bearer Authentication", createAPIKeyScheme()))

                // 全局安全要求
                .addSecurityItem(new SecurityRequirement().addList("Bearer Authentication"));
    }

    /**
     * 创建JWT认证方案
     * 配置Bearer Token认证方式
     */
    private SecurityScheme createAPIKeyScheme() {
        return new SecurityScheme()
                .type(SecurityScheme.Type.HTTP)
                .bearerFormat("JWT")
                .scheme("bearer")
                .description("JWT认证令牌，请在此处输入Bearer Token（格式：Bearer <token>）");
    }
}